<?php

/**
* showdoc
* @catalog 接口简介/专辑相关
* @title 添加专辑
* @description 添加专辑的接口
* @method POST
* @url /home-api/worship-albums
* @json_param { "name": "名称", "description": "描述", "worship_hymns": "赞美诗", "pic_url": { "id": 1, "origin_filename": "1.png", "path": "uploads\/1.png" }, "play_count": 1, "hymn_count": 1 }
* @param name 可选 string 名称 
* @param description 可选 string 描述 
* @param worship_hymns 可选 string 赞美诗 
* @param pic_url 可选 string 封面 
* @param play_count 可选 string 播放数 
* @param hymn_count 可选 string 记录数 
* @return { "name": "名称", "description": "描述", "worship_hymns": "赞美诗", "pic_url": { "id": 1, "origin_filename": "1.png", "path": "uploads\/1.png" }, "play_count": 1, "hymn_count": 1 }
* @return_param id string ID
* @return_param name string 名称
* @return_param description string 描述
* @return_param worship_hymns string 赞美诗
* @return_param pic_url string 封面
* @return_param play_count string 播放数
* @return_param hymn_count string 记录数
* @return_param created_at string 创建时间
* @return_param updated_at string 更新时间
* @return_param deleted_at string 删除时间
* @remark 错误信息：
* @number 99
*/

/**
* showdoc
* @catalog 接口简介/专辑相关
* @title 编辑专辑
* @description 编辑专辑的接口
* @method PUT
* @url /home-api/worship-albums/{id}
* @json_param { "name": "名称", "description": "描述", "worship_hymns": "赞美诗", "pic_url": { "id": 1, "origin_filename": "1.png", "path": "uploads\/1.png" }, "play_count": 1, "hymn_count": 1 }
* @param name 可选 string 名称 
* @param description 可选 string 描述 
* @param worship_hymns 可选 string 赞美诗 
* @param pic_url 可选 string 封面 
* @param play_count 可选 string 播放数 
* @param hymn_count 可选 string 记录数 
* @return { "name": "名称", "description": "描述", "worship_hymns": "赞美诗", "pic_url": { "id": 1, "origin_filename": "1.png", "path": "uploads\/1.png" }, "play_count": 1, "hymn_count": 1 }
* @return_param id string ID
* @return_param name string 名称
* @return_param description string 描述
* @return_param worship_hymns string 赞美诗
* @return_param pic_url string 封面
* @return_param play_count string 播放数
* @return_param hymn_count string 记录数
* @return_param created_at string 创建时间
* @return_param updated_at string 更新时间
* @return_param deleted_at string 删除时间
* @remark 错误信息：
* @number 99
*/

/**
* showdoc
* @catalog 接口简介/专辑相关
* @title 删除专辑
* @description 删除专辑的接口
* @method DELETE
* @url /home-api/worship-albums/{id}
* @param 参数名 是否必选 类型 说明
* @return {}
* @return_param 参数名 类型 说明
* @remark 错误信息：
* @number 99
*/

/**
* showdoc
* @catalog 接口简介/专辑相关
* @title 专辑列表
* @description 获取专辑列表的接口
* @method GET
* @url /home-api/worship-albums
* @param name 可选 string 名称 
* @param description 可选 string 描述 
* @param worship_hymns 可选 string 赞美诗 
* @param pic_url 可选 string 封面 
* @param play_count 可选 string 播放数 
* @param hymn_count 可选 string 记录数 
* @return { "name": "名称", "description": "描述", "worship_hymns": "赞美诗", "pic_url": { "id": 1, "origin_filename": "1.png", "path": "uploads\/1.png" }, "play_count": 1, "hymn_count": 1 }
* @return_param id string ID
* @return_param name string 名称
* @return_param description string 描述
* @return_param worship_hymns string 赞美诗
* @return_param pic_url string 封面
* @return_param play_count string 播放数
* @return_param hymn_count string 记录数
* @return_param created_at string 创建时间
* @return_param updated_at string 更新时间
* @return_param deleted_at string 删除时间
* @return_param current_page int 当前页页码
* @return_param from int 起始位置
* @return_param last_page int 总页码
* @return_param per_page int 每页显示的条数
* @return_param to int 结束位置
* @return_param total int 总条数
* @remark 错误信息：
* @number 99
*/

/**
* showdoc
* @catalog 接口简介/专辑相关
* @title 专辑详情
* @description 获取专辑详情的接口
* @method GET
* @url /home-api/worship-albums/{id}
* @param 参数名 是否必选 类型 说明
* @return { "name": "名称", "description": "描述", "worship_hymns": "赞美诗", "pic_url": { "id": 1, "origin_filename": "1.png", "path": "uploads\/1.png" }, "play_count": 1, "hymn_count": 1 }
* @return_param id string ID
* @return_param name string 名称
* @return_param description string 描述
* @return_param worship_hymns string 赞美诗
* @return_param pic_url string 封面
* @return_param play_count string 播放数
* @return_param hymn_count string 记录数
* @return_param created_at string 创建时间
* @return_param updated_at string 更新时间
* @return_param deleted_at string 删除时间
* @remark 错误信息：
* @number 99
*/